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PREFACE 


This  reference  manual  for  the  BBN  BitMapped  Graphics  (BMG)  system  is  intended  primarily  for 
Interlisp  programmers  who  wish  to  interface  an  application  directly  to  the  graphics  system.  It  serves 
the  secondary  purpose  of  an  introductory  manual  for  the  non-lnterlisp  programmer  who  needs  to 
build  another  interface  to  the  graphics  system  using  the  low-level  stream  protocol  between  machines. 
Finally,  it  serves  as  an  overview  for  those  graphics-knowledgable  systems  designers  who  would  like 
general  information  about  the  structure  of  this  graphics  system. 
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1.  INTRODUCTION 


1  ROSEBUD  PASS  BUMUMOt  VUMD 


This  is  the  second  design  and  implementation  round  of  the  BMG  (for  BitMapped  Graphics) 
package  in  use  at  BBN's  Information  Sciences  Division  for  experimentation  with  the  concepts  and 
limitations  of  raster  scan  graphics  systems.  The  system  is  expressly  designed  for  area-type 
manipulations,  much  in  the  spirit  of  [Teitelman,  1977]  and[Sproull,  1979].  It  is  being  used  by 
research  projects  in  command  and  control  systems,  natural  language  systems,  and  other  advanced 
user  interface  work. 

The  BMG  design  presented  here  is  the  outgrowth  of  discussions  among  Eugene  Ciccarelli, 
Norton  Greenfeld,  Martin  Yonke,  and  Frank  Zdybel.  Frank  defined  the  functional  interface  described 
below;  Norton  implemented  the  Interlisp  functions;  and  Gene  implemented  the  PDP-11  package 
which  supports  the  system. 

This  design  should  be  considered  an  intermediate  one,  since  it  is  part  of  an  evolving  view  of 
advanced  raster  graphics  systems.  It  also  represents  a  compromise  between  our  conceptual  desires 
and  the  reality  of  the  hardware  currently  available. 

This  report  documents  the  functional  interface  for  user  programs  written  in  Interlisp  as  well  as 
the  communication  protocol  between  the  PDP-11  and  the  Decsystem-20.  The  latter  is  included  in 
order  that  other  interfaces  can  be  written.1 


Fully  current  and  more  detailed  information  can  be  found  in  the  following  files,  all  in  directory 
<FONTWORK>  on  system  BBN-TENEXD: 


BMG. 

BMG.COM 

BMG . N0DECL-C0M 
BMG. DESCRIBED 
BMG11.M11 
BMG 11 . INFO 
BMG 1 1 -SPECS . DOC 


Interlisp  source  code 

Compiled  version  of  BMG  with  type  checks 

Compiled  version  of  BMG  without  type  checks 

Documentation  for  BMG  functions 

Source  code  for  6MGU 

Documentation  for  BMG11 

Documentation  for  the  BMG/BMG11  protocol 


Hardware 


The  hardware  currently  available  consists  of  a  low- resolution  (576x454)  black  and  white  bitmap 
system  (with  two  independent  planes  and  monitors)  connected  to  a  PDP-11/35,  which  in  turn  is 
connected  via  a  low-speed  line  (9600  baud)  to  a  Decsystem-20.  The  PDP-i  1  is  used  as  a  (somewhat 
large)  graphics  terminal  and  manages  the  bitmap  itself,  the  keyboard,  a  digitizer  tablet,  and 
communication  with  the  Decsystem-20.  User  programs  run  in  that  larger  system. 

1  An  interface  to  the  circuit-design  system  SUPS  has  already  been  imptemented. 
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The  POP- 11/35  has  192K  bytes  of  memory  and  an  80Mbyte  disk  (not  used  for  anything  other 
than  bootstrapping).  It  also  has  a  writable  control  storage  (not  used  by  the  BMG  system)  and  a 
BBN-built  pager  for  22-bit  virtual  addresses  (used  to  reference  memory  above  the  first  64K  bytes).  The 
bitmap  is  produced  by  Symbolic  Systems  Inc.,  and  allows  the  processor  to  reference  the  bitmap  as 
either  a  device  on  the  Unibus  or  as  part  of  memory.  Other  I/O  devices  include  a  keyboard,  a 
Summagraphics  BITPAD  tablet,  and  a  serial  line  to  a  Decsystem-20. 

In  this  paper,  the  term  "BMG"  refers  to  the  Interlisp  system  residing  in  the  Decsystem-20,  while 
"BMGl  1 "  refers  to  the  PDP-1 1  support  system. 

Overview 

Conceptually,  the  system  addresses  planes  and  regions  which  are  rectangular  areas  of  bitmap. 
Planes  can  be  considered  to  be  "real"  pieces  of  memory;  regions  are  logical  areas  within  a  plane. 
The  coordinate  system  sense  is  the  normal  one:  the  lower  left  corner  is  0,0;  the  Y  direction  increases 
positively  going  up;  the  X  direction  increases  positively  going  right. 

There  are  two  real-screen  planes,  0  and  1 .  Both  are  the  same  size,  with  X  ranging  from  0 
through  575, 2  and  Y  from  0  through  453.  These  values  are  inclusive  ••  points  with  X  =  0  and  X  =  575  lie 
on  the  screen,  similarly  for  Y  =  0  and  Y  =  453.  These  planes  are  directly  tied  to  video  monitors 
(through  the  bitmap  hardware),  with  a  0  or  1  bit  value  seen  visually  as  either  a  white  or  black  pixel 
(depending  on  current  settings  via  BMG  VideoSense). 

There  is  one  off-screen  memory  plane,  2.  This  is  twice  as  high  as  the  real-screen  planes, 
though  it  has  the  same  width.  Thus  for  plane  2,  X  ranges  from  0  through  575,  Y  from  0  through  907. 
This  plane  is  not  directly  related  to  any  video  monitor,  but  can  be  used  for  local  (PDP-11)  storage  of 
bitmaps. 

Every  region  has  properties  relating  to  its  location  (its  plane  and  limits),  its  graphics  functions 
(its  current  internal  position,  display  mode,  current  font,  background  pattern),  and  its  general  text 
functions  (its  internal  scroll  height,  line  spacing,  left  margin,  and  TTY  cursor  character).  Regions  may 
overlap  each  other. 

All  addressing  is  region -relative  (except  for  defining  the  region  limits).  All  graphic  objects 
displayed  in  a  region  are  clipped  at  the  region's  boundaries,  except  for  "unescorted  text"  sent  to  the 
TP/  region,  which  is  "wrapped  around"  to  the  next  line. 

At  all  times  there  are  two  streams  of  output  going  from  BMG  to  BMGl  1 :  graphics  commands 
and  general  "unescorted”  text.  Consequently,  there  are  two  distinguished  regions  (which  can  be 

2 

AM  numbers  mentioned  are  in  decimal,  except  in  the  Appendix. 
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changed  dynamically),  the  "current  graphics  region"  and  the  "current  TTY  region".  All  normal 
output  to  the  terminal  will  go  into  the  current  TTY  region;  graphics  output  is  done  using  the  BMGxxx 
functions  described  below. 

Similarly,  there  are  two  streams  of  input:  normal  type-in  and  "events"  such  as  a  timeout  or  a 
button  hit  on  the  digitizer.  All  four  of  these  logical  streams  are  multiplexed  over  a  single  TOPS20 
terminal  line3. 


3Sinc«  neither  Inter  Hap  nor  TOPS20  particularly  help  with  such  multiplexing,  there  are  circumstances  of  which  a  user  must 
be  careful.  They  will  be  described  at  the  appropriate  points  below. 
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2.  FUNCTIONALOVERVIEW 


The  following  are  the  Interlisp  functions  which  interface  to  the  BMG  system.  All  parameters  and 
values  are  type-checked  (using  the  DECL  package  [Teitelman,  1978]).  The  type  declarations  are 
contained  in  the  next  section.  A  non -type-checked  BMG  version  is  also  available  for  application 
systems  which  are  highly  debugged  and  require  maximum  efficiency. 

The  following  sections  are  organized  by  functional  group;  for  easy  reference,  complete 
descriptions  can  be  found  in  the  alphabetical  listing  (pp.  19-40). 


2.1  Initializationand  Synchronization 

BMGlnit  []  Starts  up  BMG,  resetting  terminal  type. 

BMGReset  [wipeFIg] 

Resets  state  of  system  to  default. 

BMGResetTTY  [regionNumber] 

Clears  the  region  and  sets  the  current  position  at  the  appropriate  point  for  text. 
BMGShowPlane  [planeNumber] 

Returns  a  BMGPIaneSpecListRecord  if  the  plane  is  defined,  and  NIL  otherwise. 
BMGlnputP  (]  Checks  to  see  whether  there  are  any  un- processed  events  on  BMGEventList. 
BMGOutFlush  [] 

Rushes  the  Interiisp,  TENEX  and  BMG  output  buffers. 

BMGlnFlush  []  Discards  the  input  events  waiting  on  BMGEventList  and  resets  it  to  NIL.  Also  clears 
the  BMG  read  buffer  (for  general  terminal  input). 

BMGEventFlush  [] 

Discards  the  input  events  waiting  on  BMGEventList  and  resets  it  to  NIL. 

BMGVideoSense  [planeNumber;  videoSense] 

Sets  the  video  sense  of  the  designated  plane,  returning  the  previous  setting.  If 
videoSense  is  null,  the  current  setting  is  returned  without  side-effect. 

BMGBellEnable  [enableSetting] 

Tells  the  system  what  action  to  take  upon  encountering  a  control-G  in  the  TTY  stream. 
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2.2  ManipulatingCharacteristics  of  Display  Regions 

Note  that  for  the  current  implementation,  all  regions  are  forced  to  have  a  left  boundary  which  is 
a  multiple  of  16  (i.e.  the  value  given  is  truncated)  and  a  right  boundary  which  is  one  less  than  a 
multiple  of  16  (increased  to  the  next  such  number).  The  top  and  bottom  boundaries  can  be  any  value. 
This  restriction  has  been  made  for  efficiency  reasons,  and  will  be  removed  in  the  next  implementation. 

BMGOefineRegion  [regionSpecList] 

This  function  combines  allocating  a  region  number,  locating  the  region,  and 
specifying  its  characteristics. 

BMGGetRegionNumber  [] 

Finds  and  returns  an  unassigned  display  region  number. 

BMGFreeRegionNumberf  regionNumber] 

Declares  that  the  region  associated  with  the  given  region  number  is  of  no  further 
interest  by  freeing  the  region  number  for  re-assignment  via  BMGGetRegionNumber. 

BMGLocateRegion  [planeNumber;  minX;  maxX;  minV;  maxY;  regionNumber] 

Locates  the  region  on  the  designated  plane  with  the  given  boundaries. 

BMGDisplayMode  [displayMode;  regionNumber] 

Changes  the  display  mode  of  the  region. 

BMGBackground  [background;  regionNumber] 

Sets  the  background  shade  of  the  region,  returning  the  old  value. 

BMGFont  [fontNumber;  regionNumber] 

Sets  the  font  of  the  region,  returning  the  previous  value. 

BMGScrollHeight  [scrollHeight;  regionNumber] 

Sets  the  scrolling  height  for  the  region,  returning  the  previous  value. 

BMGLineSpacing  [lineSpacing;  regionNumber] 

Sets  the  value  of  line  feed  (in  terms  of  raster  lines)  for  the  region. 

BMGLeftMargin  [leftMargin;  regionNumber] 

Sets  the  left  margin  for  text  for  the  region. 
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2.3  Interrogatingthe  States  of  Display  Regions 


BMGShowRegion  [regionNumber] 

Generates  a  region  specification  list  of  the  kind  used  by  BMGDefineRegion,  to 
describe  the  specified  region. 

BMGX  [regionNumber] 

Returns  the  x  coordinate  of  the  current  position  within  the  region  (in  region  relative 
coordinates.) 

BMGY  [regionNumber] 

Returns  the  y  coordinate  of  the  current  position  within  the  region  (in  region  relative 
coordinates.) 

BMGMinX  [regionNumber] 

Returns  the  x  coordinate  of  the  left  hand  edge  of  the  region  (in  plane  relative 
coordinates.) 

BMGMaxX  [regionNumber] 

Returns  the  x  coordinate  of  the  right  hand  edge  of  the  region  (in  plane  relative 
coordinates.) 

BMGMinY  [regionNumber]  * 

Returns  the  y  coordinate  of  the  lower  edge  of  the  region  (in  plane  relative 
coordinates.) 

BMGMaxY  [regionNumber] 

Returns  the  y  coordinates  of  the  upper  edge  of  the  region  (in  plane  relative 
coordinates.) 


2.4  ManipulatingDisplay  Regions 


BMGScrollRegion  [scrollHeight;  regionNumber] 

Causes  the  region  to  scroll  upwards  by  scrollHeight. 

BMGCopyRegion  [srcRegionNumber;  destRegionNumber] 

Fills  the  destination  region  with  the  contents  of  the  source  region. 

BMGRHRegion  [background;  regionNumber] 

Fills  the  region  with  the  specified  background. 
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2.5  GraphicOutput 

BMGRegion  [regionNumber] 

Sots  the  current  graphics  region  to  regionNumber,  returning  the  number  of  the 
previous  graphics  region. 

BMGTTYRegion  [regionNumber] 

Sets  the  current  TTY  region  to  be  regionNumber,  returning  the  number  of  the 
previous  TTY  region. 

BMGMove  [xCoord;  yCoord;  regionNumber] 

Makes  (xCoord, yCoord)  in  region  relative  coordinates  be  the  current  position  within 
the  region. 

BMGMoveRel  [deltaX;  deltaY;  regionNumber] 

Changes  the  current  position  within  the  region  by  the  amount  specified  by  deltaX  and 
deltaY. 

BMGPoint  [xCoord;  yCoord;  regionNumber] 

Draws  a  point  (sensitive  to  the  display  mode)  in  the  region  at  the  location  specified  in 
region  relative  coordinates. 

BMGPointRel  [deltaX;  deltaY;  regionNumber] 

Changes  the  current  position  by  the  amount  specified  by  deltaX  and  deltaY  and  draws 
a  point  according  to  the  preset  display  mode. 

BMGLine  [posl  XCoord;  posl  YCoord;  pos2XCoord;  pos2YCoord;  regionNumber] 

Draws  a  line  between  the  two  specified  positions  in  the  region,  according  to  the  preset 
display  mode. 

BMGLineRel  [deltaX;  deltaY;  regionNumber] 

Draws  a  line  from  the  current  position  in  the  region  to  the  relative  position  specified  by 
deltaX  and  deltaY  according  to  the  preset  display  mode. 

BMGPolyline  [endPoints;  regionNumbe] 

Draws  a  connected,  segmented  line  thru  the  endPoints  starting  at  the  current 
position. 

BMGPolylineRel  [deltas;  regionNumber] 

Draws  a  connected,  segmented  line  thru  the  positions  starting  at  the  current  position. 

BMGCircle  [radius;  regionNumber] 

Draws  a  circle  at  the  current  location  in  the  region. 


BMGEtlipse  [semiMinorRadius;  semiMajorRadius;  orientation;  regionNumber] 


Report  No.  4368 


Bolt  Beranek  and  Newman  Inc. 


Draws  an  ellipse  at  the  current  location  in  the  region. 

BMGChar  [charCode;  regionNumber] 

Draws  the  character  designated  by  charCode  from  the  current  font  set  at  the  current 
position  in  the  region. 

BMGString  [string;  regionNumber] 

Prints  (using  PRIN3)  the  given  string  with  the  current  font  starting  at  the  current 
location  in  the  region. 


2.6  Graphiclnput  and  Cursor  Control 


BMGTabletEnable  [enableSetting] 

Used  to  activate  or  deactivate  the  graphic  tablet  without  disturbing  the  tablets’ 
settings  as  defined  via  BMGT abletCursorState  and  BMGTabletButtonState. 

BMGT  abletCu  rsorState[cursorState] 

Sets  the  cursor  state  for  the  graphics  cursor. 

BMGT  abletButtonState[enableMask] 

Used  to  control  the  behavior  of  the  graphic  tablet. 

8MGTabletRegion  [regionNumber] 

Sets  the  BMG  region  which  will  act  as  a  confining  boundary  for  the  tablet  cursor,  as 
well  as  provide  which  plane  the  cursor  will  appear  on. 

BMGSetTimer  [setting] 

Starts  the  graphics  process  timer  independently  of  the  tablet  timer. 

BMGGetEvent  [wait] 

Returns  a  tablet,  a  graphics  process  or  tablet  or  timer  event,  or  NIL  if  none  is  waiting. 
BMGSpliceEvent  [eventSplice] 

Arranges  for  splicing  a  string  into  the  TTY  input  stream  to  announce  the  occurance  of 
an  event. 

BMGReadTabletPosition  fl 

Returns  an  event  record  describing  the  current  state  of  the  tablet. 
BMGTTYCursorEnablefenableSetting] 

Enables  or  disables  the  showing  of  the  TTY  cursor  in  the  current  TTY  region. 
BMGTTYCursorChar  [charCodeRecord;  regionNumber] 
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If  charCodeRecord  is  non-NIL,  sets  the  TTY  cursor  shape  (as  a  character  code)  for 
use  when  region  is  the  TTY  region. 


2.7  ManipulatingFonts 


Currently  available  fonts  are  in  directory  <FONTS>.  An  implementation  restriction  limits  the 
width  of  a  character  to  1 6  bits. 

BMGDefineFont  [fontNumber;  fontDescriptor;  sysResetFIg] 

Downloads  the  specified  font  from  the  Decsystem20. 

BMGDefineFontChar  [char;  fontNumber;  charHeight;  charWidth;  charMapArray] 

Specifies  a  character  in  a  font. 

BMGMakeFontFile  [fontNumber;  fontFileName] 

Causes  a  Decsystem-20  file  suitable  for  redefining  the  designated  font  to  be  written. 

BMGDescribeFont  [fontNumber] 

Returns  the  loaded  font  descriptor  corresponding  to  fontNumber  (or  NIL  if  none). 
BMGGetFontNumber  [] 

Returns  an  unused  font  number  (i.e.,  a  font  number  for  which  no  BMGDefineFont  has 
been  performed  since  the  last  BMGInit,  or  for  which  a  BMGFreeFontNumber  has  been 
performed.) 

BMGFreeFontNumber  [fontNumber] 

In  effect,  declares  that  the  font  associated  with  the  given  font  number  is  of  no  further 
interest  by  freeing  the  font  number  for  re-assignment  via  BMGGetFontNumber. 


2.8  ManipulatingOisplay  Macros  and  Display  Processes 


A  display  macro  is  a  sequence  of  graphics  commands.  A  display  process  is  an  independent 
process  within  BMG11  repeatedly  executing  some  display  macro.  One  display  macro  may  call 
another,  though  they  are  not  recursive.  (They  don’t  have  enough  computational  power  to  be  --  e.g. 
no  conditionals.)  The  process  which  executes  graphics  commands  as  they  arrive  from  BMG  is  a 
special  display  process  called  the  "graphics  process".  It  is  the  only  one  that  is  initially  created,  and  it 
cannot  be  killed.  Display  macros  may  be  executed  within  the  graphics  process  or  within  any  display 
process.  Each  display  process  (and  the  graphics  process)  have  their  own  "graphics  region”.  A 
BMGRegion  command  changes  the  graphics  region  for  the  display  process  executing  that  command 
only. 
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BMGDefineMacro  [macroNumber;  startFlg] 

Brackets  a  display  macro  definition. 

BMGExpandMacro  [macroNumber;  iterationCount;  iterationlnterval] 

Causes  the  macro  definition  associated  by  BMG  with  macroNumber  to  be  expanded 
iterationCount  times  at  a  given  frequency. 

BMGKillMacros  Q 

Kills  all  display  macro  definitions,  and  frees  all  display  macro  numbers. 
BMGShowMacros  Q 

Returns  a  list  of  the  currently  defined  display  macro  numbers. 

BMGGetMacroNumber  [] 

Allocates  an  unused  BMGMacroNumber  if  any  are  available,  otherwise  returns  NIL. 
BMG FreeMacroN umber  [macroNumber] 

In  effect,  declares  that  the  macro  associated  with  the  given  macro  number  is  of  no 
further  interest  by  freeing  the  macro  number  for  reassignment  via 
BMGGetMacroNumber. 

BMGSpawnProcess  [processNumber;  macroNumber;  iterationCount;  iterationlnterval;  regionNumber] 
Creates  and  starts  a  display  process  in  the  BMG1 1 . 

BMGPause  [delay  Time] 

Pauses  the  current  display  process  for  the  specified  time. 

BMGKillProcess  [processNumber] 

Kills  the  display  process  associated  by  BMG  with  processNumber. 

BMGGetProcessNumber  [] 

Allocates  an  unused  ProcessNumber. 

BMGFreeProcessNumber[processNumber] 

In  effect,  declares  that  the  process  associated  with  the  given  process  number  is  of  no 
further  interest  by  freeing  the  process  number  for  reassignment  via 
BMGGetProcessNumber. 
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3.  STRUCTU REDEFINITIONS 


HBCSDLMQ  PAOI  BLAMUNOT  YUMD 


V 


These  are  the  formats  of  the  (generally)  internal  records  used  by  BMG.  A  user  program  should 
deal  mainly  with  the  "spec  list"  records. 


3.1  RecordDeclarations 


( PROPRECORD  BMGP1 aneSpecL i stRecord 

( PLANE#  VIDEOSENSE  MINX  MI NY  MAXX  MAXY  OFFSCREENFLG) ) 

( PROPRECORD  BMGRegionSpecLi stRecord 

(REGION#  PLANE  MINX  MAXX  MINY  MAXY  CURRENTX  CURRENTY 
DISPLAYMOOE  BACKGROUND  SCROLLHEIGHT  LINESPACING 
LEFTMARGIN  FONT  TTYCURSORCHAR)) 

(TYPERECORD  BMGP1 aneRecord 

(Plane\PlaneNumber  PlaneXPlaneVideoSense  PlaneXMinX  PlaneXMaxX 
PlaneXMinY  PlaneXMaxY  PI aneXOffScreenFlg ) 

PlaneXOf fScreenFIg  _T) 

(TYPERECORD  BKGRegionRecord 

( Reg i on X Number  RegionXPlaneNumber  RegionXMinX  RegionXMaxX 
RegionXMinY  RegionXMaxY  RegionXCurrentX  RegionXCurrentY 
RegionXDisplayMode  RegionXFont  RegionXBackground 
RegionXScrol lHeight  RegionXLineSpacing  RegionXLeftMargin 
RegionXTTYCursorChar) ) 

(TYPERECORD  BMGLoadedFontDescriptorRecord 

(LoadedFontXNumber  LoadedFontXFileName  LoadedFontXFontRecord) ) 

(TYPERECORO  BMGFontRecord 

(FontXName  FontXHeight  FontXBaseLine 
FontXColumnPosi t ionAdjustment  FontXCharArray ) ) 

(TYPERECORD  8MGCharCode 

(CharCodeXFont  CharCodeXCode) ) 

(TYPERECORD  BMGCharDef Record 

(CharOefXCode  CharDefXRasterWidth  CharDef XWidth 
CharOefXLef tKern  CharDefXRasterArray) ) 
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(TYPERECORD  BMGProcessRecord 

(ProcessXNumber  Process\Macro  ProcessNRegion 
ProcessMterationCount  ProcessNIterationlnterval ) ) 

(RECORO  BMGEventRecord 

(EventXName  .  Event\Parametars) 
the  following  types  can  occur: 

(OownTransition  TabletSX  TabletYY) 

(UpTrans it  ion  TabletNX  Tablet\Y) 

(TabletTimeout  buttonState  Tablet\X  TabletVY) 
(GraphicsT imeout) 

(TYPERECORD  BMGTabl etCursorStateRecord 
(CursorNUpChar  CursorNDownChar) ) 

note:  both  UpChar  and  OownChar  are  BMGCharCode  records. 

( TYPERECORD  BMGButtonEnabl eRecord 

(ButtonXUpMask  Button\DownMask  Button\T imerMask  Button\Timeout) 
ButtonNUpMask  _Q  Button\DownMask  _0 
ButtonNTimerMask  _0  ButtonNTimeout  _0) 


3.2  DECLtypes 

These  type  declarations  are  defined  by  and  enforced  by  the  DECL  package  (see  Section  24.20 
in  [Teitelman,  1978]).  The  BMG.NODECL-COM  file  has  been  compiled  with  all  type-checking  deleted, 
but  should  only  be  used  after  extensive  debugging  of  an  application  program. 

BMGReg ionNumber  [SMALLP  (SATISFIES 

(ANO  ( ILEQ  VALUE  var(BMGMaxRegionMumber) ) 

(NOT  ( FMEMB  VALUE  BMGF reeReg ionNumList] 

BMGP1 aneNumber  [SMALLP  (SATISFIES 

(ANO  (ILEQ  VALUE  BMGMaxPlaneNumber) 

(NOT  (FMEMB  VALUE  BMGF reePl aneNumLi st] 

BMGScreenCoord  [FIXP  (SATISFIES  (AND  (ILEQ  VALUE  32767) 

(IGEQ  VALUE  -32768] 

CharCode  [SMALLP  (SATISFIES  (AND  (IGEQ  VALUE  0) 

(ILEQ  VALUE  128] 

(•  Note:  the  fonts  we  currently  have 
(on  the  PDP11)  have  129!  characters) 

BMGMacroNumber  [SMALLP  (SATISFIES 

(ANO  (ILEQ  VALUE  BMGMaxMacroNumber) 

(NOT  (FMEMB  VALUE  BMGFreeMacroNumList] 
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BMGProcessNumber 

BMGFontNumber 

BMGJi spl ayMode 
BMGVideoSense 


[SMALLP  (SATISFIES 

(AND  ( ILEQ  VALUE  BMGMaxProcessNumber) 

(NOT  ( FMEM8  VALUE  BMGFreeProcessNumList] 


[SMALLP  [SATISFIES 

(AND  ( IGEQ  VALUE  0) 

(ILEQ  VALUE  BMGMaxFontNumber ) 

(NOT  (FMEMB  VALUE  BMGFreeFontNumList] 


[MEMQ  ADO  REMOVE  FLIP  OVERWRITE  INVERTEDOVERWRITE] 
[MEMQ  WHITEONBLACK  BLACKONWHITE] 
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4.  FUNCTION DESCRIPTIONS 


HOCIQIIC  FAGS  BLANK.  NOT  FUMB> 


The  following  are  the  full  descriptions  of  all  BMG  functions,  cross-referenced  to  the 
function-grouping  list  above. 


"BMGBackground"  [background;  regionNumber]  (p.  8} 

description: 

Sets  the  background  shade  of  the  region,  returning  the  old  value.  Only  the  low  order 
16  bits  are  used  to  specify  a  four  pixel  square  region.  The  background  shade  is  used 
when  filling  the  region,  in  scrolling,  and  for  erasing  characters.  If  background  is  null, 
the  current  background  value  is  returned  without  side  effect.  Uses  the  current 
graphics  region  if  regionNumber  is  NIL. 
parameters: 

background  either  a  FIXP,  or  NIL 
regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  a  FIXP. 


"BMGBellEnable”  [enableSetting]  {p.  7} 

description: 

Tells  the  system  what  action  (if  any)  to  taue  upon  encountering  a  control-G  in  the  TTY 
stream.  Always  returns  the  previous  setting,  and  changes  it  only  if  enableSetting  is 
non-NIL. 
parameters: 

enableSetting  either  NIL,  'OFF,  ’AUDIO,  or  ’VISUAL. 
returns:  either  'OFF,  'AUOIO,  or  'VISUAL. 


"BMGChar”  [charCode;  regionNumber]  {p.  11} 

description: 

Draws  the  character  designated  by  charCode  from  the  current  font  set  at  the  current 
position  in  the  region.  Does  not  disturb  Interlisp’s  line  position  counter.  Does  not 
affect  the  current  position  in  the  region.  Uses  the  current  graphics  region  if 
regionNumber  is  NIL. 
parameters: 

charCode  a  CharCode. 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 

returns:  NIL. 
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“BMGCircle"  [radius;  regionNumber]  {p.  10} 

description: 

Oraw  a  circle  at  the  current  location  in  the  region.  The  current  location  in  the  region  is 
left  at  the  center  of  the  circle.  Uses  the  current  graphics  region  if  regionNumber  is 
NIL 

parameters: 

radius  a  FIXP  that  satisfies 

(IGEO  radius  0) 

regionNumber  either  a  BMGRegionNumber,  or  NIL 

returns:  NIL 


"BMGCopy  Region"  [srcRegionNumber;  destRegionNumber]  {p.  9} 

description: 

If  destRegionNumber  is  null,  the  current  graphics  region  is  assumed  to  be  the 
destination.  The  destination  region  is  filled  with  the  contents  of  the  source  region.  The 
copying  process  is  sensitive  to  the  display  mode  of  the  destination  region.  The 
regions  do  not  have  to  be  the  same  size  •  the  regions’  origins  are  aligned  and  the 
destination  region  determines  the  size  of  the  copy. 
parameters: 

srcRegionNumber  a  BMGRegionNumber. 
destRegionNumbereither  a  BMGRegionNumber,  or  NIL. 
returns:  NIL. 


"BMGDefineFont"  [fontNumber;  fontDescriptor;  sysResetFIg]  {p.  12} 

description: 

Downloads  the  specified  font  from  the  Decsystem20.  If  fontDescriptor  is  a  LIT  ATOM,  it 
is  taken  as  a  file  name  and  that  file  is  loaded.  If  it  is  a  BMGFontRecord,  a  blank  font  is 
established  for  later  manipulation  via  BMGDefineFontChar.  The  value  returned  is  the 
previous  descriptor  for  the  given  font  number,  unless  we  were  unsuccessful  at 
downloading  the  new  font.  In  this  case,  it  is  the  PDP11  response  reason.  This 
response  is  a  list:  the  first  element  is  'ERROR  and  if  we  couldn’t  load  the  font  the 
second  element  is  ’FONT  while  the  third  is  the  reason  given.  If  we  couldn’t  load  a 
character,  the  second  element  is  the  char  number,  while  the  third  is  the  reason. 
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parameters : 

fontNumber  a  FIXP  that  satisfies 

(AND  (IGEO  fontNumber  0) 

(ILEQ  fontNumber  BMGMaxNumberOfFonts)) 
fontDescriptor  either  a  BMGFontRecord,  or  a  LITATOM. 
sysResetFIg  either  NIL,  or  T. 

[ for  use  only  by  BMG  system  Ins] 

returns:  either  a  BMGLoadedFontDescriptorRecord,  or  a  non-NIL  list  that  satisfies 
(VALUE.'I  = ’ERROR) 

"BMGDefineFontChar"  [char;  fontNumber;  charHeight;  charWidth;  charMapArray]  (p.  12} 

description: 

Used  for  specifying  a  character  in  a  font.  charWidth  and  charHeight  give  the  true 
dimensions  of  the  font  cell.  In  order  to  prevent  overflow  of  the  space  actually  available 
on  the  BMG  11  for  storing  the  character,  the  program  must  previously  have  assured 
sufficient  room  in  the  font  for  the  character.  Similarly,  the  amount  of  room  for  the 
character  in  BMG11  may  be  in  excess  of  the  actual  size  of  the  character  cell. 
However,  this  situation  can  be  corrected  by  making  a  new  font  file  and  downloading  it. 
In  any  case,  BMG's  descriptor  for  the  font  is  immediately  adjusted  to  reflect  the  true 
size  of  charMapArray. 
parameters- 

char  a  CharCode. 

fontNumber  a  BMGFontNumber. 

charHeight  a  SMALLP  that  satisfies 

(IGEO  charHeight  0) 
charWidth  a  SMALLP  that  satisfies 

(IGEQ  charWidth  0) 
charMapArray  an  ARRAYP. 
returns:  a  BMGCharCode  that  satisfies 

(AND  VALUE:CharCode\Font » fontNumber 
VALUE:CharCode\Code  ■  char) 
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’’BMGDefineMacro"  [macroNumber;  startFIg]  {p.  13} 

description: 

Brackets  a  display  macro  definition.  If  startFIg  is  START,  then  this  function  will  either 
use  the  macro  number  given  or  allocate  a  new  macro  number.  It  will  delete  the 
definition,  if  it  exists,  of  the  current  display  macro  with  that  number.  After  this  call,  all 
display  primitives  called  will  be  collected  as  part  of  the  definition  of  this  macro,  until 
this  function  is  called  with  startFIg  END.  On  either  call,  a  successful  completion  is 
indicated  by  a  return  value  of  the  macro  number  being  defined,  and  an  error 
indication  by  a  list  of  'ERROR  and  the  reason. 
parameters: 

macroNumber  either  a  BMGMacroNumber,  or  NIL. 

startFIg  either  ’START,  or  'END. 

returns:  either  a  BMGMacroNumber,  or  a  non-NIL  list  that  satisfies 
(VALUE:  1  =  ’ERROR) 


"BMGDefineRegion"  [regionSpecList]  {p.  8} 

description: 

This  function  combines  allocating  a  region  number,  locating  the  region,  and 
specifying  its  characteristics.  If  an  oldRegionNumber  (i.e.  REGION#  in  the 
regionSpecList)  is  given  and  that  region  is  currently  defined,  the  specifications  in 
regionSpecList  are  applied  to  change  the  region’s  characteristics  (e.g.,  FONT, 
BACKGROUND,  DISPLAYMODE.)  If  oldRegionNumber  is  not  given,  is  NIL,  or  is  not  a 
currently  defined  region,  the  specifications  must  include  the  plane  on  which  it  is  to 
reside.  The  number  of  the  region  is  returned  as  the  value.  Note  that  the  defaults  for 
region  parameters  are  generally  specified  by  some  of  the  variables  in 
BMGDEFAULTVARS: 

(BMGOefaultRegionFontNumber  BMGDefaultRegionBackground 

BMGDefaultRegionOispiayMode  BMGDefaultRegionLineSpacing 

BMGDefaultRegionLeftMargin  BMGDefaultRegionTTYCursorChar) 
though  the  default  ScrollHeight  is  1/2  the  region  total  height,  and  the  boundaries 
default  to  the  plane's  boundaries. 
parameters: 

regionSpecList  a  BMGRegionSpecListRecord. 
returns:  either  a  BMGRegionNumber,  or  NIL. 
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"BMGDescribeFont"  [fontNumber]  {p.  12} 

description: 

Returns  the  loaded  font  descriptor  corresponding  to  fontNumber  (or  NIL  if  none). 
parameters: 

fontNumber  a  FIXP  that  satisfies 

(AND  (IGEQ  fontNumber  0) 

(ILEQ  fontNumber  BMGMaxNumberOfFonts)) 
returns:  either  a  BMGLoadedFontDescriptorRecord,  or  NIL. 

"BMGDisplayMode”  [displayMode;  regionNumber]  (p.  8} 

description: 

Changes  the  display  mode  of  the  region  if  display  mode  is  given,  returning  the 
previous  value.  If  displayMode  is  null,  returns  the  current  setting  without  side  effect. 
Uses  the  current  graphics  region  if  regionNumber  is  NIL. 
parameters: 

displayMode  either  a  BMGDisplayMode,  or  NIL. 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  a  BMGDisplayMode. 

"BMGEIlipse"  (semiMinorRadius;  semiMajorRadius;  orientation;  regionNumber]  [p.  11} 

description: 

Draws  an  ellipse  at  the  current  location  in  the  region.  At  orientation  0  the  semimajor 
axis  is  horizontal,  the  semiminor  axis  vertical.  The  current  location  in  the  region  is  left 
at  the  center  of  the  ellipse.  Uses  the  current  graphics  region  if  regionNumber  is  NIL. 
(Note:  currently  computed  by  BMG,  rather  than  BMG1 1 .) 
parameters: 

semiMinorRadius  a  FIXP  that  satisfies 

(IGREATERP  semiMinorRadius  0) 
semiMajorRadius  a  FIXP  that  satisfies 

(IGREATERP  semiMajorRadius  0) 
orientation  a  FIXP  that  satisfies 

(AND  (IGEQ  orientation  -90) 

(ILESSP  orientation  90)) 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 

returns:  NIL. 
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"BMGEventFlush"  Q  {p.7} 

description: 

Discards  the  input  events  waiting  on  BMGEventList  and  resets  it  to  NIL. 
returns:  NIL. 


"BMGExpandMacro"  [macroNumber;  iterationCount;  iterationlnterval]  {p.  13} 

description: 

Causes  the  macro  definition  associated  by  BMG  with  macroNumber  to  be  expanded 
iterationCount  times  at  a  given  frequency.  iterationCount  =  0  means  expand 
indefinitely,  iterationlnterval  is  in  lOOths  of  a  second,  and  is  measured  from  the  start 
of  one  expansion  of  the  macro  to  the  start  of  the  next. 
parameters: 

macroNumber  a  BMGMacroNumber. 

iterationCount  a  SMALLP  that  satisfies 

(AND  (IGEQ  iterationCount  0) 

(ILEQ  iterationCount  255)) 
iterationlnterval  a  F1XP. 
returns:  a  BMGMacroNumber  that  satisfies 
(VALUE  =  macroNumber) 


DMGFillRegion”  [background;  regionNumber]  (p.  9} 

description: 

Fills  the  region  with  the  specified  background.  If  background  is  null,  the  background 
shade  specified  for  the  region  via  BMGBackground  will  be  used.  Uses  the  current 
graphics  region  if  regionNumber  is  NIL. 
parameters: 

background  either  a  FIXP,  or  NIL. 
regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  NIL. 


"BMGFont"  [fontNumber;  regionNumber]  {p.  8} 

description: 

Sets  the  font  of  the  region,  returning  the  previous  value.  If  fontNumber  is  null,  the 
current  font  number  is  returned  without  side  effect.  Uses  the  current  graphics  region 
if  regionNumber  is  NIL 


24 


BMGEventFlush 


Report  No.  4368 


Bolt  Beranek  and  Newman  Inc. 


parameters: 

fontNumber  either  a  BMGFontNumber,  or  NIL. 
regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  a  BMGFontNumber. 


"BMGFreeFontNumber"  [fontNumber]  {p.  12} 

description: 

In  effect  declares  that  the  font  associated  with  the  given  font  number  is  of  no  further 
interest  by  freeing  the  font  number  for  re- assignment  via  BMGGetFontNumber. 
parameters: 

fontNumber  a  BMGFontNumber. 
returns:  NIL. 


"BMGFreeMacroNumber"  [macroNumber]  {p.  13} 

description: 

In  effect  declares  that  the  macro  associated  with  the  given  macro  number  is  of  no 
further  interest  by  freeing  the  macro  number  for  reassignment  via 
BMGGetMacroNumber.  The  macro  number  nevertheless  remains  defined  at  the 
BMG11  as  a  string  of  BMG11  command  escapes,  thus  taking  up  PDP11  memory 
space  (an  implementation  deficiency  to  be  remedied  at  a  later  date).  Note  that 
BMGKillMacros  reclaims  the  space  allocated  to  them  all. 
parameters: 

macroNumber  a  BMGMacroNumber. 
returns:  NIL. 


"BMGFreeProcessNumber"  [processNumber]  {p.  13} 

description: 

In  effect  declares  that  the  process  associated  with  the  given  process  number  is  of  no 
further  interest  by  freeing  the  process  number  for  re-assignment  via 
BMGGetProcessNumber.  This  routine  does  not  kill  the  process  (see  BMGKillProcess) 
and  it  may  be  still  active  in  the  POP- 1 1 . 
parameters: 

processNumber  a  BMGProcessNumber. 
returns:  NIL. 
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"8MGFreeRegionNumber”  [regionNumber]  {p.  8} 

description : 

Declares  that  the  region  associated  with  the  given  region  number  is  of  no  further 
interest  by  freeing  the  region  number  for  re-assignment  via  BMGGetRegionNumber. 
parameters : 

regionNumber  a  BMGRegionNumber. 
returns:  NIL. 


"BMGGetEvent"  [wait]  {p.  11} 

description: 

Returns  a  tablet,  a  graphics  process  or  tablet  or  timer  event,  or  NIL  if  none  is  waiting, 
except  that  if  wait  is  T  the  function  will  hang  until  an  event  is  generated. 
parameters: 

wait  either  NIL,  or  T. 

returns:  either  NIL  or  a  BMGEventRecord. 


"BMGGetFontNumber"  []  {p.  12} 

description: 

Returns  an  unused  font  number  (i.e.,  a  font  number  for  which  no  BMGDefineFont  has 
been  performed  since  the  last  BMGInit,  or  for  which  a  BMGFreeFontNumber  has  been 
performed.)  Takes  elements  from  BMGFreeFontNumList  if  that  global  is  non-nul;, 
otherwise  assigns  the  current  value  of  BMGNumberOfFonts  and  increments  its  value 
and  the  value  of  BMGMaxFontNumber.  If  BMGNumberOfFonts  is  EQ  to 
BMGMaxNumberOfFonts,  returns  NIL. 
returns:  either  a  BMGFontNumber,  or  NIL. 


"BMGGetMacroNumber"  []  {p.  13} 

description: 

Allocates  an  unused  BMGMacroNumber  if  any  are  available,  otherwise  returns  NIL. 
The  number  may  still  have  a  valid  definition  associated  with  it  as  far  as  BMG11  is 
concerned.  Takes  elements  from  BMGFreeMacroNumList  if  that  global  is  non-null. 
Otherwise  allocates  BMGNumberOfMacros  and  increments  the  value  of  that  global 
and  BMGMaxMacroNumber.  If  BMGNumberOfMacros  is  EO  to 
BMGMaxNumberOfMacros,  returns  NIL. 
returns:  either  a  BMGMacroNumber,  or  NIL. 
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"BMGGetProcessNumber"  []  {p.  13} 

description: 

Allocates  an  unused  ProcessNumber.  The  number  may  still  have  a  active  process 
associated  with  it  as  far  as  BMG11  is  concerned.  Takes  elements  from 
BMGFreeProcessNumList  if  that  global  is  non-null,  otherwise  allocates 
BMGNumberOfProcesses  and  increments  the  value  of  that  global  and  of 
BMGMaxProcessNumber.  If  BMGNumberOf  Processes  is  EQ  to 
BMGMaxNumberOfProcesses,  returns  NIL. 
returns:  either  a  BMGProcessNumber,  or  NIL. 


"BMGGetRegionNumber”  []  {p.  8} 

description: 

Finds  and  returns  an  unassigned  display  region  number.  Takes  elements  from 
BMGFreeRegionNumList  if  that  global  is  non- null,  otherwise  assigns  the  current  value 
of  8MGNumberOfRegions  and  increments  its  value  and  the  value  of 
BMGMaxRegionNumber.  If  BMGNumberOfRegions  is  EQ  to 
BMGMaxNumberOfRegions,  returns  NIL. 
returns:  either  a  BMGRegionNumber,  or  NIL. 


"BMGInFlush"  {]  {p.7} 

description. 

Discards  the  input  events  waiting  on  BMGEventList  and  resets  it  to  NIL.  Also  clears 
the  BMG  read  buffer  (for  general  terminal  input). 
returns:  NIL. 


"BMGInit"  []  {p.  7} 

description: 

If  the  global  BMGTerminalType  is  NIL,  first  asks  the  user  whether  he  is  using  the  BBN 
Bit  Map  terminal  and  sets  BMGTerminalType  appropriately  to  either  ’OTHER  or  'BMG 
If  necessary,  sends  appropriate  commands  to  TOPS20  to  set  up  properly  for  the  BMG 
terminal.  Calls  BMGReset  to  do  all  other  initialization. 
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"BMGKillMacros"  Q  {p.  13} 

description: 

Kills  all  display  macro  definitions,  and  frees  all  display  macro  numbers. 
returns:  NIL 


"BMGKillProcess"  [processNumber]  {p.  13} 

description: 

Kills  the  display  process  associated  by  BMG  with  processNumber.  Frees  the  process 
number. 
parameters: 

processNumber  a  BMGP  rocessNumber. 

returns :  NIL 


"BMGLeftMargin"  [leftMargin;  regionNumber]  {p.  8} 

description: 

Sets  the  left  margin  for  the  region,  that  is,  the  x  position  resulting  after  a 
carriage-return  character  is  sent  to  this  region  as  the  current  TTY  region.  The  value 
given  is  relative  to  the  left  edge  of  the  region.  Returns  the  old  value.  If  leftMargin  is 
null,  the  current  setting  is  returned  witout  side  effect.  Uses  the  current  TTY  region  if 
regionNumber  is  NIL. 
parameters: 

leftMargin  either  a  FIXP  that  satisfies 

(IGEQ  leftMargin  BMGMinLeftMargin) 

or  NIL 

regionNumber  either  a  BMGRegion Number,  or  NIL. 
returns:  a  FIXP. 


"BMGLine”  [posIXCoord;  poslYCoord;  pos2XCoord;  pos2YCoord;  regionNumber]  {p.  10} 

description: 

Draws  a  line  between  the  two  specified  positions  in  the  region,  according  to  the  preset 
display  mode.  If  pos2XCoord  and  pos2YCoord  are  NIL,  draws  a  line  from  the  current 
position  to  posIXCoord,  poslYCoord.  The  current  position  becomes  the  second 
endpoint  of  the  line.  Uses  the  current  graphics  region  if  regionNumber  is  NIL. 
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parameters: 

poslXCoord 
poslYCoord 
pos2XCoord 
pos2YCoord 
regionNumber 
returns:  NIL 


a  BMGScreenCoord. 
a  BMGScreenCoord. 
either  a  BMGScreenCoord,  or  NIL 
either  a  BMGScreenCoord,  or  NIL. 
either  a  BMGRegionNumber,  or  NIL. 


"BMGLineRer  [deltaX;  deltaY;  region  Number]  {p.  10} 

description: 

Draws  a  line  from  the  current  position  in  the  region  to  the  relative  position  specified  by 
deltaX  and  deltaY  according  to  the  preset  display  mode.  Uses  the  current  graphics 
region  if  regionNumber  is  NIL. 
parameters: 

deltaX  aFIXP. 

deltaY  aFIXP. 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 

returns:  NIL. 


"BMGLineSpacing"  [lineSpacing;  regionNumber]  {p.  8} 

description: 

Sets  the  value  of  line  feed  (in  terms  of  screen  coordinates)  for  the  region,  except  that 
lineSpacing  cannot  be  reduced  below  the  sum  of  the  maximum  height  of  the  current 
font  and  BMGMinlnterLineSpacing.  If  lineSpacing  is  null,  returns  the  current  value 
without  side  effect.  Uses  the  current  TTY  region  if  regionNumber  is  NIL. 
parameters: 

lineSpacing  either  aFIXP,  or  NIL. 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 

returns:  aFIXP. 


"BMGLocateRegion"  [planeNumber;  minX;  maxX;  minY;  maxY;  regionNumber]  (p.  8} 

description: 

Locates  the  region  on  the  designated  plane  with  the  given  boundaries.  Uses  the 
current  graphics  region  if  regionNumber  is  NIL.  Uses  the  region’s  current  values  for 
any  parameters  specified  as  NIL.  Note  that  the  current  position  after  the  locate  is  0,0 
(i.e.  the  lower  left  corner  of  the  region).  Returns  the  region  number. 
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parameters: 

planeNumber  either  a 

minX  either  a 

maxX  either  a 

minY  either  a 

maxY  either  a 

regionNumber  either  a 

returns:  a  BMGRegionNumber. 


BMGPIaneNumber,  or  NIL. 
BMGScreenCoord,  or  NIL. 
BMGScreenCoord,  or  NIL. 
BMGScreenCoord,  or  NIL. 
BMGScreenCoord,  or  NIL. 
BMGRegionNumber,  or  NIL. 


"BMGMakeFontFile"  [fontNumber;  fontFileName]  {p.  12} 

description: 

Causes  a  POP- 10  file  suitable  for  redefining  the  designated  font  to  be  written.  The 
FontOescriptor  for  the  designated  font  is  returned  with  updated  font  file  name  field.  If 
the  write  is  unsuccessful  for  any  reason,  returns  NIL. 
parameters: 

fontNumber  a  BMGFontNumber. 

fontFileName  a  LIT  AT  OM. 

returns:  either  a  BMGLoadedFontDescriptorRecord,  or  NIL. 


"BMGMaxX"  [regionNumber]  {p.  9} 

description: 

Returns  the  x  coordinate  of  the  right  hand  edge  of  the  region  in  plane  relative 
coordinates.  Uses  the  current  graphics  region  if  regionNumber  is  NIL. 
parameters: 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  aFIXP. 


••BMGMaxY'*  [regionNumber]  {p.  9} 

description: 

Returns  the  y  coordinates  of  the  upper  edge  of  the  region  in  plane  relative 
coordinates.  Uses  the  current  graphics  region  if  regionNumber  is  NIL. 
parameters: 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  aFIXP. 
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"BMGMinX"  [regionNumber]  {p.  9} 

description: 

Returns  the  x  coordinate  of  the  left  hand  edge  of  the  region  in  plane  relative 
coordinates.  Uses  the  current  graphics  region  if  regionNumber  is  NIL 
parameters: 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  aFIXP. 


"BMGMinY"  [regionNumber]  {p.  9} 

description : 

Returns  the  y  coordinate  of  the  lower  edge  of  the  region  in  plane  relative  coordinates. 
Uses  the  current  graphics  region  if  regionNumber  is  NIL. 
parameters: 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  a  FIXP. 


"BMGMove"  [xCoord;  yCoord;  regionNumber]  {p.  10} 

description: 

Makes  (xCoord,  yCoord)  in  region  relative  coordinates  be  the  current  position  within 
the  region.  Uses  the  current  graphics  region  if  regionNumber  is  NIL. 
parameters: 

xCoord  a  BMGScreenCoord. 

yCoord  a  BMGScreenCoord. 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  NIL. 

"BMGMoveRel"  [deltaX;  deltaY;  regionNumber]  {p.  10} 

description: 

Changes  the  current  position  within  the  region  by  the  amount  specified  by  deltaX  and 
deltaY.  Uses  the  current  graphics  region  if  regionNumber  is  NIL. 
parameters: 

deltaX  a  FIXP. 

deltaY  a  FIXP. 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  NIL. 
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"BMGOutFlush"  []  {p.  7} 

description: 

Rushes  the  Interlisp,  TENEX  and  BMG  output  buffers. 
returns :  NIL. 


"BMGPause"  [delayTime]  {p.  13} 

description: 

Pause  the  current  display  process  for  the  specified  time.  delayTime  given  in  lOOths  of 
a  second,  and  is  1 5  bits  only  (thus,  the  maximum  delay  time  is  around  6.5  seconds). 
parameters: 

delayTime  a  FIXP. 

returns:  NIL. 


"BMGPoint"  [xCoord;  yCoord;  regionNumber]  {p.  10} 

description: 

Draws  a  point  (sensitive  to  the  display  mode)  in  the  region  at  the  location  specified  in 
region  relative  coordinates.  Changes  the  current  position  to  the  given  position.  Uses 
the  current  graphics  region  if  regionNumber  is  NIL. 
parameters: 

xCoord  a  BMGScreenCoord. 

yCoord  a  BMGScreenCoord. 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 

returns:  NIL. 


"BMGPointRel"  [deltaX;  deltaY;  regionNumber]  {p.  10} 

description: 

Changes  the  current  position  by  the  amount  specified  by  deltaX  and  deltaY  and  draws 
a  point  according  to  the  preset  display  mode.  Uses  the  current  graphics  region  if 
regionNumber  is  NIL. 
parameters: 

deltaX  aRXP. 

deltaY  a  HXP. 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 

returns:  NIL 
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"BMGPolyLine"  [endPoints;  regionNumber]  {p.  10} 

description: 

Draws  a  connected,  segmented  line  thru  the  endPoints  starting  at  the  current 
position.  endPoints  can  be  either  a  list  of  (X  .  Y)  cons  cells,  or  a  generator  handle 
which  will  successively  produce  the  (X  .  Y)  pairs.  The  current  position  is  left  at  the  last 
end  point  in  the  list.  Uses  the  current  graphics  region  if  regionNumber  is  NIL. 
parameters: 

endPoints  either  a  list  of  (CONS  X  Y)  end  point  positions,  or  a  generator 

handle,  i.e.  a  non-NIL  list  that  satisfies 
[OR  [for  entry  in  endPoints  always 

(AND  (type?  BMGScreenCoord  (CAR  entry)) 

(type?  BMGScreenCoord  (CDR  entry] 

[AND  (STACKP  (CAR  endPoints)) 

(STACKP  (CDR  endPoints]] 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  NIL. 

"BMGPolyLineRer  [deltas;  regionNumber]  (p.  10} 

description: 

Draws  a  connected,  segmented  line  thru  the  positions  starting  at  the  current  position, 
deltas  can  be  either  a  list  of  (deltaX.Y)  cons  cells,  or  a  generator  handle  which  will 
successively  produce  the  (deltaX.Y)  pairs.  The  current  position  is  left  at  the  last  point 
drawn.  Uses  the  current  graphics  region  if  regionNumber  is  NIL. 
parameters: 

deltas  either  a  list  of  (CONS  deltaX  deltaY)  relative  positions,  or  a 

generator  handle,  i.e.  a  non-NIL  list  that  satisfies 
[OR  [for  entry  in  deltas  always 
(AND  (type?  FIXP  (CAR  entry)) 

(type?  FIXP  (CDR  entry] 

[AND  (STACKP  (CAR  deltas)) 

(STACKP  (CDR  deltas]] 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  NIL. 
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"BMGReadTabletPosition"  Q  {p.  1 1} 

description: 

Returns  an  event  record  describing  the  current  state  of  the  tablet,  or  NIL  if  the  tablet  is 
not  turned  on.  If  an  error  response  is  received  from  the  BMG11,  returns  (LIST 
’ERROR  reason). 

returns:  either  NIL  or  a  BMGEventRecord. 


"BMGRegion”  [regionNumber]  {p.  10} 

description: 

Sets  the  current  graphics  region  to  regionNumber,  returning  the  number  of  the 
previous  graphics  region.  If  regionNumber  is  null,  returns  the  number  of  the  current 
grahics  region  without  side  effect. 
parameters: 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  a  BMGRegionNumber. 


"BMGReset"  [wipeFIg]  {p.  7} 

description: 

Resets  the  planes  to  BMGDefaultPlaneRecords.  If  wipeFIg  is  non  null,  each  plane  is 
filled  according  to  the  value  of  the  global  variable  BMGDefaultPlaneBackground. 
Then  the  initial  state  of  the  system  it  set  according  to  the  variables  on 
BMGDEFAULTVARS.  The  ones  which  are  used  here  are: 

(BMGDefaultRegionSpecLists  BMGDefaultCurrentRegion 

BMGDefaultCurrentTTYRegion  BMGDefaultBellEnable  BMGDefauItTabletCursorState 
BMGDefauItT  abletRegion  BMGDefauItTabletEnable 

BMGDefauItT abletButtonEnableMask  BMGDefauItTTVCursorEnable  BMGDefaultFont 
BMGDefaultSpliceEvent). 
parameters: 

wipeRg  either  NIL,  or  T. 


"BMGResetTTY”  [regionNumber]  (p.  7} 

description: 

This  function  clears  the  region  and  sets  the  current  position  within  that  region  at  the 
appropriate  point  for  text  (upper  left,  minus  one  baseline  and  to  the  right  of  the  left 
margin  by  LeftMargin).  Uses  the  current  TTY  region  if  regionNumber  is  NIL. 
parameters: 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  NIL. 
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"BMGScrollHeight"  [scrollHeight;  regionNumber]  {p.  8} 

description : 

Sets  the  scrolling  height  for  the  region,  returning  the  previous  value.  This  is  the 
amount  (in  terms  of  screen  coordinates)  that  the  display  region  is  scrolled  upward 
when  BMGScrollRegion  is  called  (except  that  a  scrollHeight  of  0  means  to  clear  the 
entire  region  and  start  at  the  top).  Scrolling  will  also  occur  in  the  TTY  region  when 
text  reaches  the  bottom  of  that  region.  In  this  case,  a  negative  scroll  height  means 
"wait  for  the  user  to  type  control-RQ”  and  then  scroll;  a  positive  scroll  height  of  zero 
means  an  automatic  clear  and  siart  at  the  top  of  the  region.  If  scrollHeight  is  null,  the 
current  value  is  returned  without  side  effect.  Uses  the  current  TTY  region  if 
regionNumber  is  NIL. 
parameters : 

scrollHeight  either  a  F1XP,  or  NIL. 
regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns :  aFIXP. 

"BMGScrollRegion"  [scrollHeight;  regionNumber]  {p.  9} 

description: 

Causes  the  region  to  scroll  upwards  by  scrollHeight  pixels  if  scrollHeight  is  non-null, 
otherwise  by  the  amount  set  for  the  region  via  BMGScrollHeight.  Uses  the  current  TTY 
region  if  regionNumber  is  NIL. 
parameters: 

scrollHeight  either  a  FIXP,  or  NIL. 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  NIL. 

"BMGSetTimer"  [setting]  {P- 11} 

description: 

Starts  the  graphics  process  timer  independently  of  the  tablet  timer.  The  timer  setting 
is  given  in  lOOths  of  a  second.  When  the  timer  expires,  an  event  is  generated. 
parameters: 

setting  a  FIXP  that  satisfies 

(IGREATERP  setting  0) 

returns:  NIL. 
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"BMGShowMacros"  Q  {p.  13} 

description : 

returns  a  list  of  the  currently  defined  display  macro  numbers. 
returns :  a  list,  or  NIL 


"BMGShowPlane"  [planeNumber]  {p.  7} 

description: 

Returns  a  BMGPIaneSpecListRecord  if  the  plane  is  defined,  and  NIL  otherwise. 
parameters: 

planeNumber  a  RXP. 
returns:  either  a  BMGPIaneSpecListRecord,  or  NIL. 


"BMGShowRegion"  [regionNumber]  {p.  9} 

description: 

Generates  a  region  specification  list  of  the  kind  used  by  BMGDefineRegion,  to 
describe  the  specified  region.  If  regionNumber  is  null,  the  current  graphics  region  is 
described.  If  there  is  no  region  of  the  given  number,  returns  NIL. 
parameters: 

regionNumber  either  a  FIXP,  or  NIL. 
returns:  a  BMGRegionSpecListRecord,  or  NIL. 


"BMGSpawnProcess"  [processNumber;  macroNumber;  iterationCount;  iterationlnterval; 

regionNumber]  {p.  13} 

description: 

Create  and  start  a  display  process  in  the  PDP-1 1 ,  telling  it  to  execute  a  given  display 
macro  n  times  at  a  given  frequency  (as  if  the  display  process  had  a  top  level 
BMGExpandMacro  command)  and  use  a  given  graphics  region  initially  (the  current 
graphics  region  if  regionNumber  is  NIL).  When  the  display  process  is  done,  it  wit!  kill 
itself.  If  the  specified  iterationCount  is  0,  the  display  process  will  execute  the  display 
macro  indefinitely  (until  killed  by  a  BMGReset,  or  killed  specifically  by  a 
BMGKillProcess,  etc.).  The  iterationlnterval  is  in  lOOths  of  a  second  (and  is  limited  to 
15  bits). 
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parameters: 

processNumber  either  a  BMGProcessNumber,  or  NIL. 
macroNumber  a  BMGMacroNumber. 

iterationCount  a  SMALLP  that  satisfies 

(AND  (IGEO  iterationCount  0) 

(ILESSP  iterationCount  256)) 
iterationlnterval  a  FIXP. 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 

returns:  either  a  BMGProcessNumber,  or  a  non-NIL  list  that  satisfies 
(VALUE:  1  ERROR) 

"BMGSpliceEvent"  [eventSplice]  {p.  11} 

description: 

Arranges  for  splicing  a  string  into  the  TTY  input  stream  to  announce  the  occurance  of 
an  event.  If  eventSplice  is  a  string,  that  string  will  be  spliced  into  the  input  stream  and 
the  event  record  will  still  be  available  in  the  event  queue.  If  eventSplice  is  EQ  to 
'RECORD  the  string  spliced  in  will  be  the  pname  of  the  event  record,  and  the  event 
records  will  no  longer  be  available  on  BMGEventList.  If  eventSplice  is  EQ  to  'OFF  the 
splice  feature  is  turned  off.  If  eventSplice  is  null,  the  previous  value  of  eventSplice  is 
returned  without  side  effect. 
parameters: 

eventSplice  either  a  STRINGP,  'RECORD,  or  OFF,  or  NIL. 

returns:  either  a  STRINGP,  or  'RECORD,  or  'OFF. 

"BMGString"  [string;  regionNumber]  (p.  11} 

description: 

Prints  (using  PRIN3)  the  given  string  with  the  current  font  starting  at  the  current 
location  in  the  region.  Does  not  affect  Interlisp's  current  line  position  counter.  Does 
not  affect  the  current  position  in  the  region.  Uses  the  current  graphics  region  if 
regionNumber  is  NIL.  The  string  is  clipped  (by  whole  characters)  to  stay  in  the  region. 
parameters: 

string  anything. 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  NIL. 
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"BMGTabletButtonState"  [enableMask]  {p.  11} 

description: 

Used  to  control  the  behavior  of  the  graphic  tablet.  enableMask  contains  the  enable 
bits  for  all  of  the  2-state  devices  on  the  system  (currently  only  one  button,  for  the 
Summagraphics  BITPAD  tablet.)  The  Up  and  Down  masks  give  enables  for  event 
reporting  for  the  respective  up  and  down  transitions  of  each  device,  and  the  timer 
mask  gives  the  enables  for  starting  the  tablet  timer  on  the  transition.  The  old  setting  is 
returned. 
parameters: 

enableMask  either  a  BMGButtonEnableRecord,  or  NIL 
returns:  a  8MGButtonEnableRecord. 

"BMGTabletCursorState”  [cursorState]  {p.  11} 

description: 

Sets  the  cursor  state  for  the  graphics  cursor,  if  cursorState  is  non-NIL.  Returns  the 
current  state. 
parameters: 

cursorState  either  a  BMGTabletCursorStateRecord,  or  NIL. 
returns:  a  BMGTabletCursorStateRecord. 

"  BMGT abletEnable"  [enableSetting]  {p.  1 1 } 

description: 

Used  to  activate  or  deactivate  the  graphic  tablet  without  disturbing  the  tablets’ 
settings  as  defined  via  BMGTabletButtonState  and  BMGTabletCursorState.  When  the 
tablet  is  off,  the  tablet  cursor  is  not  displayed  and  BMGReadTabletPosition  returns 
NIL.  Returns  the  previous  activation  state.  If  enableSetting  is  null,  returns  the  old 
state  without  changing  it. 
parameters: 

enableSetting  either  'ON,  'OFF,  or  NIL. 
returns:  either  ’ON,  or  'OFF. 


"BMGTabletRegion"  [regionNumber]  {p.  11} 

description: 

Sets  the  BMG  region  which  will  act  as  a  confining  boundary  for  the  tablet  cursor,  as 
well  as  provide  which  plane  the  cursor  will  appear  on.  Returns  the  old  region,  and 
does  not  change  it  if  the  input  is  NIL. 
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parameters: 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  a  BMGRegionNumber. 


"BMGTTYCursorChar"  [charCodeRecord;  regionNumber]  {p.  12} 

description: 

If  charCodeRecord  is  non-NIL,  sets  the  TTY  cursor  shape  (as  a  character  code)  for 
use  when  region  is  the  TTY  region.  Uses  the  current  TP/  region  if 
regionNumber  =  NIL.  Always  returns  the  previous  TTY  cursor  char  for  the  region. 
parameters: 

charCodeRecord  either  a  BMGCharCode,  or  NIL. 
regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  a  BMGCharCode. 


"BMGTTYCursorEnable"  [enableSetting]  f p.  11} 

description: 

Enables  or  disables  the  showing  of  the  TTY  cursor  in  the  current  TTY  region.  Returns 
the  previous  setting.  If  enableSetting  is  null,  returns  the  current  setting  without 
changing  it. 
parameters: 

enableSetting  either  NIL,  'ON,  or  'OFF. 
returns:  either  'ON,  or  'OFF. 


"BMGTTYRegion"  [regionNumber]  {p.  10} 

description: 

Sets  the  current  TTY  region  to  be  regionNumber,  returning  the  number  of  the 
previous  TTY  region.  If  regionNumber  is  null,  returns  the  number  of  the  current  TTY 
region  without  side  effect. 
parameters: 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  a  BMGRegionNumber. 


"BMGVideoSense"  [planeNumber;  videoSense]  {p.  7} 

description: 

Sets  the  video  sense  of  the  designated  plane,  returning  the  previous  setting.  If 
videoSense  is  null,  the  current  setting  is  returned  without  side-effect. 
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parameters: 

planeNumber  a  BMGPIaneNumber. 

videoSense  either  a  BMGVideoSense,  or  NIL. 

returns:  a  BMGVideoSense. 


"BMGX”  [regionNumber]  {p.  9} 

description: 

Returns  the  x  coordinate  of  the  current  position  within  the  region  (in  region  relative 
coordinates.)  Uses  the  current  graphics  region  if  regionNumber  is  NIL. 
parameters: 

regionNumber  either  a  BMGRegion  Number,  or  NIL. 
returns:  aFIXP. 


"BMGY"  [regionNumber]  {p.  9} 

description: 

Returns  the  y  coordinate  of  the  current  position  within  the  region  (in  region  relative 
coordinates.)  Uses  the  current  graphics  region  if  regionNumber  is  NIL. 
parameters: 

regionNumber  either  a  BMGRegionNumber,  or  NIL. 
returns:  aRXP. 
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APPENDIX  A 

BMG  COMMANDS  ACCEPTED  BY  BMG1 1 


This  appendix  details  the  protocol  between  BMG  and  BMG1 1.  it  is  here  for  use  in  implementing 
non-BMG  interfaces  to  BMG11.  Note,  numbers  in  this  appendix  are  in  octal  unless  otherwise 
indicated. 

A .  1  BMGl  1  Functions 


This  column  has  the  name  of  the  BMG11  routine.  To  find  out  what 
command  number  this  is,  see  the  table  later  in  this  section. 

-  BMG  function  that  sends  this  command  to  BMG11, 

|  description  of  arguments  sent,  and  a  list  of  the 
j  possible  responses  from  the  11,  if  any. 

I 


General  initialization  and  synchronization 


Note:  All  numbers  in  the  Appendix  are  in  octal,  not  decimal. 

Restart  BMGReset 

no  arguments. 

RegOot  BMGRegion 

{(small Number  reg ionNumber ) ) 

RegTTY  BMGTTYRegion  (negative  means  local  printing  TTY) 

(( smal INumber  reg ionNumber)) 

TopTTY  BMGResetTTY 

no  arguments. 

VidOef  BMGVideoSense 

(( smal INumber  planeNumber)  (character  videoSense  (W  8))) 
TRCOn  BMGTTYCursorEnable 

{(flag)) 

TRCChar  BMGTTYCursorChar 

(( smal INumber  font) ( character  charCode)) 

SetBe  1 1 S  ta  teBMGBellEnable 

{( smal INumber  bellState)) 

0  -  do  nothing 

1  -  ring  bell 

2  -  flash  screen 

SndAck  (internal  to  BMG) 

no  arguments. 
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REGLIM 

REGDPM 

REGFNT 

REGBKG 

REGSCR 

RegLSp 

RegLMar 


Returns  a  response  of  no  arguments,  of  type  J.  Used 
for  synchronization.  Note  that  sending  a  *E  (ascii 
005)  through  the  TTY  stream  will  also  return  this 
response.  Thus,  to  change  TTY  region  parameters  the 
following  sequence  can  be  used  to  ensure  that  the 
parameters  get  changed  AFTER  all  previous  TTY  output 
has  been  displayed,  and  BEFORE  ell  subsequent  TTY 
output  is  displayed: 

1.  Ensure  that  the  TTY  stream  is  empty  c.y  sending  tE 
through  the  TTY  stream  and  awaiting  the  acknowledge. 

2.  Change  the  TTY  region  parameters. 

3.  Ensure  that  the  paramters  are  changed  by  sending 
a  SndAck  command  through  the  graphics  stream  and 
awaiting  the  acknowledge. 


Region  parameter  setting  commands 


BMGLocateRegion  Does  not  change  current  region. 

The  current  position  for  the 
specified  region  is  reset  to  0,0. 
((small Number  reg ionNumber) 

(smallNumber  plane) 

(number  maxX) 

(number  minX) 

(number  maxY) 

(number  minY)) 

BMGDisplayMode 

((smallNumber  displayMode) ) 

0  *  Add  (logical  or),  1  =  remove  (clear,  i.e. 
complement  and  then  logical  and),  1  -  flip 
(xor),  3  *  overwrite  (jam),  and  4  =  inverted 
overwrite  (complement  and  then  jam). 

BMGFont 

((smallNumber  font)) 

BMGBackground  Does  no  filling,  note. 

((word  backgroundShade)) 

BMGScrollHeight 

((number  sc ro 1 1  Amount)) 

Sets  amount  that  TTY  scrolling  will  scroll  by. 
BMGLineSpacing 

((number  lineSpacing)) 

Sets  amount  of  TTY  inter-line  spacing 
BMGLeftMargin 
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((number  leftMargin)) 

Sets  region-relative  left  margin  for  CR 


Operations  that  work  on  ail  bits  in  a  region 


REGGRY  BMGFillRegion 

{(word  greyPattern)) 

REGMOV  BMGCopyRegion 

((smallNumber  sourceReg ion) 

(smal INumber  destinationRegion) ) 

Copies  bits  from  one  region  to  another. 

No  reference  or  change  to  graphics  region. 
RegSc  ro  1 1  BMGScrollRegion 

((number  scrol lOistance)) 

Scrolls  current  TTY  region.  (Note:  this  does 
not  scroll  the  current  graphics  region! ) 


Current  position  setting,  point  and  line  drawing 


MovAL  BMGMove 

((number  X)  (number  Y)) 

MovALX  BMGMove  (in  just  x...) 

((number  X)) 

MovALY  ...  (in  just  y) 

((number  Y)) 

MovRL  BMGMoveRel 

((number  Xincrement)  (number  Yincrement)) 

MovRS  BMGMoveRel  (by  small  amount  in  x  and  y) 

( (sSmal INumber  Xincrement)  (sSmallNumber  Yincrement)) 
MovRSX  ...  (by  small  amount  in  just  x) 

((sSmallNumber  Xincrement)) 

MovRSY  ...  (by  small  amount  in  just  y) 

((sSmallNumber  Yincrement)) 

1  i  nAL  BMGLine 

((number  X)  (number  Y)) 

LinALX  BMGLine  (in  just  x) 

((number  X}) 

LinALY  ...  (in  just  y) 

({number  Y)) 

LinRL  BMGLineRei 

((number  Xincrement)  (number  Yincrement)) 

LinRS  BMGLineRei  (by  small  amount  in  x  and  y) 

((sSmallNumber  Xincrement)  (sSmallNumber  Yincrement)) 
.  (by  small  amount  in  just  x) 


LinRSX 
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LinRSY 

PntAL 

PntALX 

PntAL Y 

PntRL 

PntRS 

PntRSX 

PntRSY 

REGSTR 

Circle 

Ellipse 


Note  that 
cursor  is 

TbCOn 

TbCChar 

SetTbReg 

TbRead 

TbEvent 


((sSmall Number  Xincrement)) 

...  (by  small  amount  in  just  y) 

((sSma 11  Number  Yincrement)) 

BMGPoint 

((number  X)  (number  Y)) 

BMGPoint  (in  just  x) 

((number  X)) 

...  (in  just  y) 

((number  Y)) 

BMGPointRel 

((number  Xincrement)  (number  Yincrement)) 

BMGPointRel  (by  small  amount  in  x  and  y) 

(( sSmal 1  Number  Xincrement)  ( sSmall Number  Yincrement)) 
(by  small  amount  in  just  x) 

(( sSmall Number  Xincrement)) 

...  (by  small  amount  in  just  y) 

(( sSmal 1  Number  Yincrement)) 

BMGString  ((string)) 

SMGCircle  ((number  radius)) 

BMGEIlipse  For  now  just  a  circle  with  radius  *  major, 
((number  orientation) 

(number  semiMinorRadius) 

(number  semiMajorRadius) ) 


Tablet  operations 


the  tablet  is  always  "in"  some  region,  and  the  tablet 
constrained  to  be  visually  within  that  region. 

BMGTabletEnabie 

((Hag)) 

BMGT  abletCursorState 

((character  buttonState  (U  "up",  D  "down")) 

(smallNumber  tabletFont) 

(character  tabletCharacter)) 

BMGTabletfiegion  ((smallNumber  regionNumber) ) 

BMGReadTabletPosition  (no  arguments) 

returns  a  response  of  type  H  and  arguments: 

((character  buttonState  (U  0)) 

(number  currentX) 

(number  currentY)) 

BMG  T  abletButtonState 

((character  event  (U  0)) 

(flag  enableOrOisable) 

(number  timeout))  0  means  no  timeout. 

Timeout  in  lOOths  (decimal)  of 

i 
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InstFont 


LoadFont 


FreeFont 


LoadChar 


a  second. 


Font  operations 


BMGInstallFont  Font  as  currently  defined  will 

be  defined  when  a  BMGReset 
is  done. 

(( smal 1  Number  fontNumber)) 

returns  a  response  of  no  arguments  with  type: 

E  No  room  to  install  the  font  (intalling 

implies  a  copy). 

F  Non-existant  fontNumber  or  an 

attempt  to  install  TVFONT. 

G  OK  --  font  is  installed. 

BMGDefineFont  reserves  space  for  font 

(( smal 1  Number  fontNumber) 

(smallNumber  fontHeight) 

(smal 1  Number  fontBasel  ine) ) 
returns  a  response  of  no  arguments  with  type: 

E  No  room  for  a  new  loaded  font. 

F  Font  cannot  be  loaded:  either  no  such 

font  number  or  is  already  loaded. 

G  OK  —  font  is  loaded. 

BMGFreeFontNumber  ((smallNumber  fontNumber)) 
returns  response  of  no  arguments  with  type: 

F  No  such  font  number  or  undefined. 

G  OK  —  font  is  freed. 

BMGDefineFontChar 

Note  that  the  character  width  may  be  at  most  16  decimal. 
((smallNumber  NumberOfBytesToFol low) 

(smallNumber  fontNumber) 

(smallNumber  charCode) 

(smallNumber  leftKern) 

(smallNumber  charWidth) 

(word  rastertine) . . )  {as  many  as  in  height(font)} 
returns  a  response  of  no  arguments  and  type: 

0  Number  of  raster  lines  coming  does  not 

match  the  font's  height. 

E  No  room  to  load  another  character. 

F  No  such  font  number  or  undefined. 

G  OK  --  character  is  defined. 
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aVT52 


DHPause 


OMOef ine 


General  input  operations 


(internal  BMG  function) 

( { smal 1  Number  NumberOf By tesToFol low) 

(string  preOelim) 

(string  postDelim)) 

[Note  that  number  of  bytes  includes  the  two 
string  terminators.  Also  note  that  these 
delimiter  strings  are  not  allowed  to  contain 
nulls,  ascii  0.  They  may  contain  octal  200 
though,  which  may  amount  to  the  same  effect 
as  far  as  the  host  is  concerned.] 

Any  message  from  the  /II  to  the  /10  is 
proceeded  by  the  preDelim  and  followed  by  the 
postDelim.  Initial  values  are: 
preDelim  *  "tA(" 
postDelim  =  ")<CRLF>" 

BMGSetTimer  ((number  timeOutLimi t) ) 


VT52  emulation 


Enter  vt52  simulation,  (not  used  by  BMG) 
no  arguments. 


Display  Macros  and  Display  Processes 


BMGPause 

Pause  the  current  process  for  a  certain  time, 
specified  in  IQOths  (decimal)  of  a  second. 

((number  time)) 

BMGDefineMacro 

Start  a  definition  of  a  display  macro.  All 
bytes  sent  after  the  first  argument,  the 
DMIO,  become  part  of  the  display  macro, 
up  to  the  terminator  —  an  026  (decimal) 
byte  followed  by  an  027  (actually  any 
non-028).  The  two-byte  sequence  026  026 

turns  into  a  single  026  that  will  be  part  * 

of  the  display  macro,  (i.e.  026  026  is  •  ■ 

a  "quoted  026".) 

((small Number  DMIO)  I' 


0 
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(byte  byteOfMacro) . . . 

026  027) 

returns  a  response  of  type: 

G  OK,  display  macro  defined. 

E  No  room,  display  macro  not  defined. 

e.g.  couldn't  allocate  needed  space 
for  the  display  macro  bytes,  or  for 
the  internal  definition  block. 


BMGExpandMacro 

Execute  a  display  macro  n  times  at  a  given  frequency. 
(The  interval  from  the  start  of  one  execution  of  the 
display  macro  to  the  start  of  the  next  is  specified, 
in  lOOths  of  a  second.) 

((small Number  OMID) 

(smallNumber  iterationCount) 

(number  iterationlnterval ) ) 

(internal  BMG  function) 

Execute  one  of  two  display  macros  depending 
on  the  state  of  the  table  (button-up  or 
button-down).  The  current  position  is  first 
moved  to  be  at  the  current  tablet  position 
before  executing  the  display  macro. 

((smallNumber  DMIDup) 

(smallNumber  DMIDdown) 

(smallNumber  iterationCount) 

(number  iterationlnterval) 

BMGKillMacros 

Kill  all  display  macro  definitions.  (The 
implementation  had  to  take  some  shortcuts 
to  finish  in  time  and  this  is  one:  no  garbage 
collector,  no  freeing  of  just  part  of  the 
display  macro  storage.) 


BMGSpawn  Process 

Create  and  start  a  display  process,  telling  it  to 
execute  a  given  display  macro  n  times  at  a  given 
frequency  (as  if  the  display  process  had  a  top  level 
DMExecute  command)  and  use  a  given  graphics  region 
initially.  When  the  display  process  is  done,  it  will 
kill  itself.  If  the  specified  iteration  count  is  0, 
the  display  process  will  execute  the  display  macro 
indefinitely.  (Until  killed  by  a  DPKill,  or  a 
BMGReset  is  done,  etc.) 

((smallNumber  OP  ID )  {the  new  display  process's  ID} 
(smallNumber  region) 
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(smallNumber  OMIO)  {what  display  macro  to  execute} 
(smal INumber  iterationCount) 

(number  iterationlntervai ) ) 

returns  a  response  of  type: 

G  OK,  process  created  and  running. 

E  No  room,  process  not  created,  i.e.,  no 

room  to  allocate  the  internal  overhead 
(process  control  block,  display 
process  control  block)  or  if  the  DPID 
is  already  in  use  by  some  other 
display  process. 


DPKill  BMGKillProcess 

Kill  a  running  display  process,  given  its  ID. 
((smallNumber  OPID)) 


A .  2  Character  Sequence  Syntax 

The  following  describes  the  character  sequences  sent  over  the  graphics  stream  for  various 
command  formats.  Note  that  the  characters  sent  over  the  graphics  stream  are  not  necessarily  the 
exact  characters  sent  to  the  PDP1 1 .  For  instance,  some  characters  must  be  quoted  to  get  into  the 
graphics  stream,  e.g.  to  get  a  tR  (022  octal)  into  the  graphics  stream,  the  two  character  sequence  tR 
R  (022  122)  must  be  sent.  These  escape  sequences  for  quoting  (and  others  for  stream-switching)  are 
thus  not  considered  part  of  the  graphics  stream  ••  they  are  at  a  lower  level  than  streams. 

Argument  description  legend 

< argument- list> ::  *  "("  <argument>  <argument> ...  ")" 

<argument> ::  a  "("  <type>  <optional-name>  <optional-value-list>  ")" 

Optional-value-list  gives  the  possible 
values  that  may  be  used  for  this  argument 

<type> ::  a  character  |  flag  |  string  |  smallNumber  | 
sSmallNumber  |  number  |  word 


character 


flag 


Type  Formats 

one  8-bit  byte  in  the  range  0  through  and  including  200  octal.  8-bit  values  above 
that  are  considered  the  same  as  if  they  had  their  200-bits  off,  so  except  for  the  200 
value,  characters  are  only  7  bits. 

one  character,  either  "Y"  or  "N". 
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t  a(a  xggordinate  a&flflgtioata) 

Downward  button  transition. 

tA(B  xCoordinate  vCoordinate) 

Upward  button  transition. 

t  A(C  buttonState  xgaacdinaia  YCoordingts) 

Timeout  waiting  for  button  transition. 

tA(D)  Error  from  LoadChar:  number  of  raster  lines  coming  in  character  definition  does 

not  match  height  of  font. 

t A(E)  No  room  for  requested  operation,  i.e.  BMG1 1  cannot  allocate  space  for  a  new 

font,  character,  or  process.  (Note  that  installing  a  font  implies  copying  it.)  Sent  by 
InstFont,  LoadFont,  and  LoadChar. 

tA(F)  No  such  value  allowed.  Either  an  argument  was  out  of  range  (i.e.  fonts  are  0-16) 

or  the  value  is  in  a  legal  range  but  specifies  something  not  defined,  e.g.  trying  to 
load  a  character  into  an  unloaded  font.  Or,  attempting  to  install  font  0,  TVFONT, 
which  is  pre-installed  and  not  allowed  to  be  altered.  Sent  by  InstFont,  LoadFont, 
and  LoadChar. 

*A(G)  Acknowledgment  -•  the  operation  was  successful.  Sent  by  InstFont.  LoadFont, 

and  LoadChar. 

t  A(H  buttopStete  ^Coordinate  yCoordinats) 

Response  to  command  from  host  to  read  the  tablet.  This  is  a  self-consistent  state 
for  some  time  after  the  read-tablet  command  and  before  the  time  sent  by  BMG11. 
When  received  and  processed  by  BMG  routines  (and  their  callers),  the  current 
tablet  state  may  be  different,  so  care  is  necessary  in  using  this. 

tA(l)  The  timer  (set  by  BMGSetTimer)  went  off.  (It  goes  off  at  most  once  for  each  time  it 

is  set.  If  another  BMGSetTimer  resets  it,  the  old  setting  is  lost) 

tA(J)  A  response  to  a  TTY  or  graphics  stream  acknowledge  request.  Can  be  used  for 

synchronizing  operations  between  streams,  e.g.  changing  TTY  region  parameters. 

A .  3  Low-level  TTY/Graphics  stream  switching 

All  input  (including  nulls  (0)  and  rubouts  (177),  which  are  fine  characters)  is  buffered  in  one  of 
two  buffers:  TTY  input  buffer,  TI8,  or  graphics  input  buffer,  GIB.  We  simulate  what  we  would  really 
like,  which  is  two  communication  lines  or  at  least  two  decent  end-to-end  protocol-controlled  streams. 
Since  we  don't  have  the  requisite  stream  support  on  the  host  side,  in  lntertisp/10,  we  have  a  simple 
approximation  to  a  good  protocol:  there  are  some  reserved  character  sequences  which  switch 
between  the  two  streams,  handled  at  interrupt-time: 
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tRT  (Control-R  followed  by  T)  will  switch  to  the  TTY  stream. 
tRG  will  switch  to  the  graphics  stream. 
tRU  (U  for  "up")  PUSHes  to  the  TTY  stream,  explained  below. 
tRD  (D  for  "down")  POPs  from  the  TTY  stream,  explained  below. 

(Control-R  was  chosen  so  not  to  be  a  small  and  frequent  number  -  like  Control- A,  which  is  what 
we  had  before.  It  should  also  have  an  even  parity  so  its  200-bit  won’t  be  turned  on  by  the  simple 
printing  that  might  do  TTY  pushes.) 

Consecutive  tRs  act  as  one  tR  -  in  other  words,  if  x  is  any  character,  then  rFL.tRx  does 
whatever  tRx  does.  This  is  to  add  robustness  in  the  face  of  an  outstanding  tR  followed  by  the  death 
or  interruption  of  the  program  that  sent  it. 

The  interrupt-level  routines  must  also  be  able  to  manage  the  tS/tQ  "flow-control"  protocol,  in 
two  directions  if  enabled:  the  host  operating  system  (TOPS20,  presumably)  can  be  told  that  we  will 
send  a  tS  when  (either  of)  our  input  buffers  are  nearly  full  and  tQ  when  they  are  (both)  nearly  empty. 
The  tS  tells  the  host  to  stop  sending  until  it  gets  a  tQ.  That  can  be  turned  off,  which  is  lucky  since 
this  removes  tS  and  tO  from  the  set  of  useful  characters  you  can  send  through  to  some  application 
program  on  the  host  -  e.g.  EMACS  (and  our  input  buffers  -  the  TTY  stream  one  is  all  that  matters  for 
EMACS  -  are  large  enough  so  the  flow-control  isn’t  needed).  In  the  other  direction,  things  are  not  so 
flexible:  the  host  '--ill  send  us  a  tS  when  its  (small  --  e.g.  around  40  characters)  input  buffer  is  nearly 
full,  and  that  does  not  seem  to  be  able  to  be  turned  off.  Thus  we  must  lose  tS  and  tQ  from  the  set  of 
characters  that  the  host  can  send  us. 

Note  that  the  host  sends  us  tS  with  the  "parity"  bit  (i.e.  200  bit)  ON  (for  TOPS20  Release  4  and 
later)  and  OFF  for  TENEX  and  TOPS20  before  Release  4.  We  have  the  variable  Ctl.S  to  specify  which 
-  right  now  the  only  way  to  switch  between  them  is  in  DDT  e.g.  to  set  it  type  "ctl.s/023"  followed  by  a 
return. 

Since  we  thus  lose  rO  (021 )  and  tS  (023  on  some  systems,  223  on  others)  (in  addition  to  tR,  our 
escape  command)  we  need  some  low- level  quoting  fo  allow  rR,  tQ,  and  tS  to  go  through  a  stream.  In 
these  quote  sequences,  the  second  character  is  formed  by  logically  ORing  in  100  octal,  with  the  200 
bit  being  ignored: 

tRR  (Control-R  R,  or  022  122,  or  022  322)  quotes  a  tR,  octal  022  — 

•i.e.  it  turns  into  a  single  Control-R  in  whichever  is  the 
currently  selected  stream. 

tRQ  (Control-R  Q,  or  022  121  etc.)  quotes  a  tQ,  octal  021. 

tRS  (Control-R  S,  or  022  123  etc.)  quotes  a  tS,  octal  023  or  223, 
whichever  Ctl.S  is  set  to. 

Octal  222,  221,  and  either  023  or  223  (whichever  Ctl.S  is  NOT  set  to)  are  like  normal  characters 
and  need  no  special  action. 
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Pushing  to  and  popping  from  the  TTY  stream  is  designed  for  stupid  (i.e.  minimally  controlled), 
unexecpected  output,  for  instance  the  low-level  Interlisp  messages  generated  by  a  Control-T  or 
garbage  collection.  Pushing  to  the  TTY  stream  switches  to  the  TTY  stream,  pushing  the  current 
stream.  Popping  restores  the  last  stream  pushed.  Since  there  is  no  state  (essentially  -•  except  for 
TTY  font-switching,  but  that’s  very  safe)  in  the  TTY  stream,  pushing  from  either  stream  is  simply  a 
matter  of  remembering  which  of  the  two  streams  it  was.  There  is  no  way  to  push  to  the  graphics 
stream,  as  that  stream  has  a  large  amount  of  state.  Thus,  stupid  output  cannot  do  anything  fancy  - 
i.e.  it  cannot  use  the  graphics  stream. 

Switching  between  streams  via  tRT  and  tRG  resets  the  stream-stack,  in  case  the  stupid 
ouputters  are  losing  control.  The  stream-stack  is  simply  an  up-down  counter,  TPushCount,  of  how 
many  times  we  have  pushed  to  the  TTY  stream,  and  a  variable,  TGBase,  that  says  whether  we  started 
pushing  from  the  TTY  or  graphics  stream.  The  currently  selected  stream  is  recorded  by  the  PC  of  the 
input  interrupt  routine’s  coroutine. 

A .  4  Assignment  of  command  numbers 

The  following  is  the  dispatch  table  for  BMG  commands.  Commands  are  indexed  by  an  8-bit 
byte,  so  there  are  256  commands  -•  though  a  lot  of  them  are  illegal  in  that  they  go  to  BadCom  and  it 
prints  a  complaint  and  then  tries  to  resynchronize  by  ignoring  all  characters  in  the  graphics  stream 
until  that  stream  is  empty  -  assuming  that  that  point  is  likely  to  be  a  graphics  com  start.  The  reason  it 
has  to  do  this  is  that  if  the  command  is  unknown,  its  syntax  is  too  --  and  we  don’t  know  how  many  of 
the  following  bytes  are  arguments  to  that  unknown  command  and  how  many  are  succeeding 
commands. 

Restart  is  command  0,  TopTTY  is  command  1 ,  etc. 

DspchT : 


NoOp 

NoOp 

TopTTY 

BMGResetTTY 

REG00T 

BMGRegion 

REGTTY 

BMGTTYRegion 

VIDOEF 

BMG  VideoSense 

SetMsgOel 1ms 

BMGSetlnputDel imiters 

SetTimer 

BMGSetTimer 

SndAck 

end  BMGGraphicsAcknowledge  (tE  in  TTY  stream) 

Restart 

BMGReset 

REGLIM 

BMGLocateRegion 

REGDPM 

BMGDisplayMode 

REGFNT 

BMGFont 

REGBKG 

BMGBackground 

RegSHeight 

BMGScrollHeight 

RegLSp 

BMGLineSpacing 

RegLMar 

BMGLeftMargin 

REGGRY 

BMGFillRegion 

REGMOV 

BMGCopyRegion 
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RegScrol 1 

RegChar 

REGSTR 

MovAL 

MovALX 

MovALY 

MovRL 

MovRS 

MovRSX 

MovRSY 

LinAL 

LinALX 

LinALY 

LinRL 

LinRS 

LinRSX 

LinRSY 

PntAL 

PntALX 

PntALY 

PntRL 

PntRS 

PntRSX 

PntRSY 

Circle 

Ellipse 

InstFont 

LoadFont 

FreeFont 

LoadChar 

TRCOn 

TRCChar 

TbCOn 

TbEvent 

TbCChar 

SetTbReg 

TbRead 

aVT62 

SetBel IState 

OMPause 

OMOefine 

DMExecute 

OMKill 

OPCreate 

OPKill 


BMGScrollRegion 

BMGChar 

BMGString 

BMGMove 

BMGMove  (in  just  x...) 

(in  just  y) 

BMGMoveRel 

BMGMoveRel  (by  small  amount  in  x  and  y) 
...  (by  small  amount  in  just  x) 

(by  small  amount  in  just  y) 

BMGLine 

BMGLine  ( in  just  x) 

(in  just  y) 

BMGLineRel 

BMGLineRel  (by  small  amount  in  x  and  y) 
...  (by  small  amount  in  just  x) 

...  (by  small  amount  in  just  y) 

BMGPoint 

BMGPoint  (in  just  x) 

(in  just  y) 

BMGPointRel 

BMGPointRel  (by  small  amount  in  x  and  y) 
...  (by  small  amount  in  just  x) 

(by  small  amount  in  just  y) 

BMGCircle 

BMGEIlipse 

BMGInstal 1  Font 

BMGDefineFont 

BMGFreeFontNumber 

BMGDefineFontChar 

BMGTTYCursorEnable 

BMGTTYCursorChar 

BMGTabietEnable 

BMGT  abfetButtonState 

BMGT  abletCursorState 

BMGTabletRegion 

BMGReadT  abletPosition 

Enter  vt52  simulation. 

SMGBellEnable. 

BMGPause 

BMGDefineMacro 

BMGExpandMacro 

BMGKillMacros 

BMGSpawnProcess 

BMGKiilProcess 
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BMG  Background  -  function  8, 12.,  24,  42, 52 

BMGBellEnable  --  function  7, 12, 41,  S3 

BMGChar  -  function  11. i$.53 

BMGCircle  -  function  10, 12, 44,  53 

BMGCopyRegion  -  function  9,  20, 43, 52 

BMGDefaultBeMEnable  -  global  variable  34 

BMGOefaultCurrentRegion  -  global  variable  34 

BMGDefauitCurrentTTYRegion  -  global  variable  34 

BMGDefaultFont  ••  global  variable  34 

BMGOefaultPlaneSackground  -  global  variable  34 

BMGDefauitPlaneRecords  -  global  variable  34 

BMGDef aultRegionBackgrou  nd  -  global  variable  22 

8MGDefaultRegionDisplayMode  -  global  variable  22 

BMGDefaultRegionFontNumber  -  global  variable  22 

BMGDefaultRegionLeftMargin  -  global  variable  22 

BMGDef  aultRegionUneSpacing  -  global  variable  22 

BMGDelaultRegionSpect.ists  -  global  variable  34 

BMGDefaultRegionTTYCursorChar  global  variable  22 

BMGDef aultSpliceEvent  -  global  variable  34 

BMGDefauItTabietButtonEnableMask  -  global  variable 
34 

BMGDefauItTabletCursorState  global  variable  34 
BMGOefauItTabletEnable  -  global  variable  34 
8MGDefauitTabietRegion  -  global  variable  34 
8MGOefaultTTYCursorEnable  ••  global  variable  34 
BMGOEFAULTVARS  ••  global  variable  22. 34 
BMGDef  ineFont  ••  function  12.  2Q,  26, 45, 53 
BMGDefinef  ontChar  --  function  12,20,21,45,53 
BMGDef ineMacro  ••  function  12,  21. 46, 53 
BMGDefineRegion  -  function  8, 9, 22, 36 
BMGOescribeFont  -  function  12, 22 
BMGOispiayMode  --  function  8, 22, 42, 52 
BMGEWpse  function  10, 22, 44, 53 
BMGEventFluab  ••  function  7, 22 


BMGEventList  -■  global  variable  7, 27 
BMGExpandMacro  -  function  13. 24. 36.  47.  S3 
BMGFillRegion  -  function  9, 24, 43,  52 
BMGFont  -•  function  8, 2±,  42, 52 
BMGFreeFontNumber  -  function  1 2,  2£,  26, 45, 53 
BMGFreeFontNumList  -•  global  variable  17,  26 
BMGFreeMacroNumber  ••  function  13,  29 
BMGFreeMacroNumList  -  global  variable  16, 26 
BMGFreePianeNumUst  -  global  variable  16 
BMGFreeProcessNumber  -  function  13, 25 
BMGFreeProcessNumList  -  global  variable  17,  26 
BMGFreeRegionNumber  -  function  8,  25. 
BMGFreeRegionNumList  -  global  variable  16,  27 
BMGGetEvent  -  function  1 1 ,  29 
BMGGetFontNumber  -  function  1 2,  25.  29 
BMGGetMacroNumber  -  function  13,  25, 29. 
BMGGetProcessNumber  -  function  13, 25.  29 
BMGGetRegionNumber  --  function  8,  25, 2Z. 
BMGInFlush  -  function  7, 21 
BMGInit -- function  7,12,26.21 
BMGlnputP  -  function  7,  27 
BMGKillMacros  -•  function  13,  25,  2L  *7, 53 
BMGKillProcess  -  function  13. 25. 29. 36, 46. 53 
BMGLeftMargin  -  function  8, 29.  *2. 52 
BMGUne  -  function  10,  29>  43,  53 
BMGLineRel  -  function  10,29,43.53 
BMGlineSpacing  -•  function  8.  29, 42. 52 
BMGLocateRegion  ••  function  8, 29. 42, 52 
BMGMakeFontFile  ••  function  12,99 
BMGMaxFontNumber  -  global  variable  17, 26 
BMGMaxMacroNumber  ••  global  variable  16,26 
BMGMaxNumberOfFonta  --  global  variable  20.23.26 
BMGMaxNurriberOf  Macros  -  global  venabie  26 
BMGMaxNumberOfProcasaes  -  global  variable  26 
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BMGMaxNumbefOf  Regions  ••  global  variabla  27 
BMGMaxPtaneNumber  global  variable  16 
BMGMaxProcesaNumber  -  global  variable  17,26 
BMGMaxRegionNumber  -  global  variable  27 
BMGMaxX  -  function  9,3a 
BMGMaxY  -  function  9,  30 
BMGMinlnteriJneSpacing  -  global  variable  29 
BMGMinLeftMargin  ••  global  variable  28 
BMGMinX  -•  function  9, 2Q 
BMGMinY- function  9.31 
BMGMove  -  function  10, 31, 43,  53 
BMGMoveRei -- function  10,31,43,53 
BMGNumberOf Fonts  -  global  variable  26 
BMGNumberOfMacros  -  global  variable  26 
BMGNumberOfProcesses  -  global  variable  26 
BMGNumberOfRegiorts  --  global  variable  27 
BMGOutFlush  --  function  7,31 
BMGPauae  -  function  13, 32, 46, 53 
BMGPoint  -  function  10, 32. 44, 53 
BMGPointRei  -  function  10.32,44,53 
BMGPolyUne -- function  10, 32. 

BMGPolyUneRel  -  function  10,3ft 
BMGReadT abletPosition  -  function  TT,  33, 38. 44. 53 
BMGRegkin  --  function  10. 12. 3j..  41.52 
BMGReset  -  function  7, 27,34,38,41,45, 47 
BMGResetTTY  --  function  7, 3£,  41 , 52 
BMGScroflHeigtit  -  function  6, 34, 35, 42, 52 
BMGScroURegion  ••  function  9. 34. 3$.  43. 52 
BMOSetTimer  ••  function  11,33.46,50,52 
BMGSriowMacros  --  function  13,  £ 

BMGShowPlane  ••  function  7,3ft 
BMGShowRegion  -  function  9. 3ft 
BMGSpawnProcess  ••  function  13, 3ft.  47, 53 
BMGSpticeEvent -•  function  11,321 
SMGStrtng -- function  11,31,44,53 
BMOTabfetButtonState  ••  function  11. 37, 38, 44. 53 
BMOTaMotCwaorState  ••  function  1 1,3ft.  36. 44, 
BMQTabfetEnabfe  -  function  11, 3ft,  44, 53 


BMGTTYCursorEnable  --  function  11.ffl.41. 53 
BMGTTYRegion  -  function  10. 38-  41.52 
BMGVideoSense  ••  function  4. 7. 39. 41.52 
BMGX  ••  function  9, 40 
BMGY  -  function  9, 4ft 

TVFONT- font  name  45,50 


